<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>Txt2tags User Guide</TITLE>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-iso-8859-1">
<LINK REL="Start" HREF="index.html">
<LINK REL="Contents" HREF="index.html">
<LINK REL="Prev" HREF="CommandLineOptions.html">
<LINK REL="Next" HREF="ConfigurationLoadingOrderandPrecedence.html">
<STYLE TYPE="text/css"><!--
BODY { font-family: serif }
H1 { font-family: sans-serif }
H2 { font-family: sans-serif }
H3 { font-family: sans-serif }
H4 { font-family: sans-serif }
H5 { font-family: sans-serif }
H6 { font-family: sans-serif }
SUB { font-size: smaller }
SUP { font-size: smaller }
PRE { font-family: monospace }
--></STYLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="userguide.css"></HEAD>
<BODY>
<A HREF="index.html">Contents</A>
<A HREF="CommandLineOptions.html">Previous</A>
<A HREF="ConfigurationLoadingOrderandPrecedence.html">Next</A>
<HR NOSHADE>

<H2><A NAME="5_7">User Configuration File (RC File)</A></H2>
<P> The user configuration file (also called RC file) is a central place
 to store the settings that will be shared by ALL converted files. If
 you keep inserting the same settings on every .t2t file you write, move
 it to the RC file and it will be used globally, for existing and future
 source files.</P>
<P> The default location of this file depends on your system. It can
 also be specified by the user, using an environment variable.</P>
<TABLE ALIGN="center" BORDER="1">
<TR><TH COLSPAN="2">RC file location</TH></TR>
<TR><TD ALIGN="right">Windows</TD><TD><CODE>%HOMEPATH%\_t2trc</CODE></TD>
</TR>
<TR><TD>UNIX, Linux, Mac</TD><TD><CODE>$HOME/.txt2tagsrc</CODE></TD></TR>
<TR><TD ALIGN="right">User defined</TD><TD><CODE>T2TCONFIG</CODE>
 variable</TD></TR>
</TABLE>
<P> The format of the settings is exactly the same as the ones used on
 the .t2t files Config Area. There is a sample RC file on the package at
 <CODE>doc/txt2tagsrc</CODE>. Example:</P>
<PRE>
% my configs

%%% Always use CSS-friendly tags in HTML
%!options(html): --css-sugar

%%% Change the default TOC depth for all targets
%!options: --toc-level 4

%%% Set the default encoding for all documents
%!options: --encoding UTF-8
</PRE>
<P> Any line that is not blank, a comment or a valid config line will
 raise error when txt2tags runs. So be careful when editing this file.</P>
<P> Txt2tags automatically apply the RC file contents into any source
 file it is converting. If you want to disable this behavior for a
 specific file, use the <CODE>--no-rc</CODE> command line option.</P>
 <A NAME="config-loading"></A><HR NOSHADE>
<A HREF="index.html">Contents</A>
<A HREF="CommandLineOptions.html">Previous</A>
<A HREF="ConfigurationLoadingOrderandPrecedence.html">Next</A>
</BODY>
</HTML>
